home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / xeno / megacd.lha / megacd / docs / MegaCD.doc < prev    next >
Text File  |  1995-10-01  |  8KB  |  198 lines
  1.        ***********************************************
  2.  
  3.        Docfile  for MegaCD-Rom Door (MegaCD)
  4.        written by David Huckett 3:640/800 @ Fidonet
  5.                     3-Jul-95
  6.       ************************************************
  7.  
  8. Shareware
  9. ---------
  10. MegaCD is now a Shareware program.. Although it is written in Arexx
  11. and it is impossible to enforce Shareware on an Arexx file (most of
  12. you will change it as you please), But there is one catch... It re-
  13. quires the program MegaRXDL which is the interface between this pr-
  14. ogram and Xenolink, to enable downloading WITHOUT having to look for
  15. messages with files attached...
  16. You will then need MegaRXDL to get the files that are found and marked
  17. within this door and add them to the file transfer list..
  18. MegaRXDL is included in this archive and can be used for other appli-
  19. cations as you desire.. There is no requirement that it has to be
  20. only used in conjunction with MegaCD..
  21. It can be used without registration according to the docs in its'
  22. archive.. But delays and the limit of 3 files marked externally, is
  23. built in to encourage registration..
  24. One registration gets you a keyfile that will cover your system for
  25. both MegaCd and MegaRXDL.. And also any future releases by me for
  26. Xenolink..
  27. Please read the Registration and Doc file within the MegaRXDL archive
  28. for information about registering..
  29.  
  30.  
  31. Licence
  32. -------
  33. MegaCD.rexx is copyrighted software, but you may distribute it freely,
  34. as long as ALL the supplied files are included, and no attempt is made
  35. to modify the main Program..
  36. MegaCD.rexx is to be ONLY USED on Xenolink BBS Software, and use with
  37. any other BBS software, without my permission will be considered a
  38. BREECH of this licence.
  39.  
  40.  
  41. Legal Stuff
  42. -----------
  43. MegaCD is supplied without ANY WARRANTIES WHATSOEVER. I accept no
  44. responsibility for any loss or damage, whether it be financial,
  45. physical, or psychological, resulting from the use or the purported
  46. use of MegaCD for any purpose whatsoever.
  47.  
  48. I make no claim that I will continue development for any specified
  49. period of time, although I do have at this time, intentions of
  50. continued development while I remain running a Xenolink BBS.
  51.  
  52. If these conditions are not acceptable to you, then you have no
  53. licence to use MegaCD.  You should delete MegaCD immediatly..
  54.  
  55.  
  56. Introduction
  57. ------------
  58. This program was written for Xenolink 1.90 + to enable access to
  59. CD-Rom files via a door.
  60. It will allow users to view the contents of the CD and select as
  61. many files as the sysop has configured, and add them to a list
  62. that is read by MegaRXDL for download in the normal system fashion.
  63.  
  64. The main feature of this door is that it uses existing text files
  65. on most BBS ready CD-Rom disks as it's source for the listings
  66. on Xenolink..  This means no more hours configuring CDs' or
  67. having 300+k files for config files on your hard drives..
  68.  
  69. NEW FEATURE  You can now configure to have any section/directory
  70. of your hard drives look as though they are CD's or you can have it
  71. display files from sections, not actually in the Xenolink filecat
  72. and have them queued for download as if they were part of your
  73. normal filecat..  I use this for all my CD-Rom Filelists, which then
  74. makes them appear in the same area as the CD files.
  75. All files transferred from within this door and via MegaRXDL,
  76. maintain system file/byte ratios..
  77.  
  78. All directory changes and file marking is done completly by number.
  79.  
  80. I have set it up to recognise a few different formats of txt files
  81. I have encountered myself, mainly files.bbs, INDEX, and 00_index.txt
  82. files..
  83.  
  84. I have made the archive of all that is required in the directories
  85. as they exist on my system.. Check each one out to find out what
  86. to do.  An explanation of the config files is included in the
  87. archive.
  88.  
  89.  
  90. FEATURES
  91. --------
  92.  * Uses Files.bbs/00_Index/INDEX files and others that exist on most
  93.    CD-Rom disks, completly avoiding extra Hard Drive wear&tear as
  94.    all the files and descriptions are read directly from the CD..
  95.  
  96.  * Normal system downloading _WITHOUT_ attaching to messages.!!
  97.  
  98.  * Ability to configure CD-Roms _WITHOUT_ file lists in each directory 
  99.  
  100.  * Ability to access virtual devices on hard drives that appear as
  101.    mounted CD-Roms..  I use a virtual as an area for CD-Rom filelists
  102.    so the filelists for all CDs' are found within the door..
  103.  
  104.  * Marked file listing including estimated D/L time and total bytes marked.
  105.  
  106.  * File ratios supported from within the Door.
  107.  
  108.  * Complete CD-Rom file list creation.
  109.  
  110.  
  111. THINGS TO DO
  112. ------------
  113.  * I am working on CD-Roms like Frozen Fish and the 17 Bit Collection
  114.    to enable the breaking down of directories (17 bit) or the merging
  115.    of directories (Frozen Fish), so that a user is not presented with
  116.    a list of files 100 screens long or a screen with only 3 files..
  117.  
  118.  * An offline request door is near completion, that will enable users
  119.    to supply a filename that may be on an OFFLINE CD disk or they are
  120.    in search of, and during an event started by a Cron, will be checked
  121.    against whatever CDs' are loaded that day.. If the file is found it
  122.    will be copied across to the hard drive and attached to a message
  123.    for the next time the user logs in..
  124.  
  125.  
  126. INSTRUCTIONS
  127. ------------
  128. Copy the directory called MegaCD into your Doors: directory
  129.      It contains the following:
  130.  
  131.  MegaCD.Rexx       The main program.
  132.  MegaCDOnline.rexx The program to display online CD's to users at login.
  133.  MCDLister.rexx    FileList creator for sysop use..
  134.  CD.Cfg            The main config file for all CDs' available.
  135.  MCD.header        A text file used as a header in your filelists that
  136.                    are created by MCDLister.rexx
  137.  
  138.  MegaRXDL.archive  The latest version of MegaRXDL will always be included
  139.                    in this archive, although it is distributed separatly
  140.                    for use in other programs..
  141.  
  142.  CONFIGS/        The directory that contains each CDs' individual
  143.                  configuration.. Usually named similar to the CDs' name
  144.                  as defined in the main CD.cfg file.
  145.                  Plus DUMMY Configs for Hard Drive areas..
  146.                  A few examples are included.
  147.  DOCS/           A Directory containing all the doc files.. Please read
  148.                  crefully as I am not the worlds best doc writer..
  149.  FILELISTS/      A directory I have created and included as an example,
  150.                  it contains two directories, one for IBM filelists and
  151.                  the other for Amiga related filelists.. Each has a
  152.                  files.bbs I wrote in a text editor with the contents
  153.                  of the directory and a description..
  154.  HDINDEXES/      This directory hold a directory for each CD that does not
  155.                  contain its' own index files in each dir.. Inside the dir
  156.                  for the CD, there exists a complete clone of the directory
  157.                  structure of the CD that did not contain any index files..
  158.                  In each of these directories on the hard drive, you create
  159.                  your own files.bbs text file containing the names and
  160.                  description of each file found in the same dir of the CD..
  161.  
  162.                  A quick way to make these files.bbs is by using the dos
  163.                  command LIST with LFORMAT to give you the format, then
  164.                  redirect it to a file..
  165.  
  166.  
  167. Make an entry in your file menu for calling MegaCD.Rexx or create another
  168.     menu up for the CD-Roms only..
  169. Eg:
  170.  
  171. CMD = "R"
  172.     {
  173.      REXX "^2^Doors:MegaCD/MegaCD.rexx ~14 ~138 ~10 ~11"
  174.     }
  175.  
  176. and recompile..
  177. Edit the top of the MegaCD.Rexx file and change the entries for:
  178. BBSNAME SYSOP MAXMARKED and a few others.
  179.  
  180. PLEASE READ THE HISTORY AND NOTES IN THE TOP OF THE MegaCD.rexx file
  181.  
  182. This Door saves a file in T:  called MRXDL<nodenumber>.sfl
  183. So it is IMPORTANT to have the configured filename in MegaRXDL as
  184. the above, using a tilde code for the node in use..
  185.  
  186. eg: XenolinkDoor "^20000^2^Doors:MegaRXDL/MegaRXDL ~20 T:MRXDL~14.sfl"
  187.  
  188. The door recognises most of the different files.bbs I have found,
  189. if you have found any that are different, let me know, as it might not
  190. take much to make it compatable.
  191.  
  192. I can be contacted in any of the Xenolink echoes if you have difficulties
  193. or have any questions.
  194. Cheers,
  195. David Huckett
  196. MegaTech BBS +61-(0)77-835-397 24hrs
  197. 3:640/800 @ Fidonet
  198.